package com.filetransfer.service;

import com.filetransfer.model.dto.DeviceDTO;
import com.filetransfer.model.entity.Device;

import java.util.List;

/**
 * 设备服务接口
 */
public interface DeviceService {
    
    /**
     * 注册设备
     *
     * @param deviceDTO 设备信息
     * @return 设备ID
     */
    String registerDevice(DeviceDTO deviceDTO);
    
    /**
     * 更新设备状态
     *
     * @param deviceId 设备ID
     * @param status 状态
     * @return 是否成功
     */
    boolean updateDeviceStatus(String deviceId, Integer status);
    
    /**
     * 更新设备名称
     *
     * @param deviceId 设备ID
     * @param deviceName 设备名称
     * @return 是否成功
     */
    boolean updateDeviceName(String deviceId, String deviceName);
    
    /**
     * 获取设备详情
     *
     * @param deviceId 设备ID
     * @return 设备信息
     */
    DeviceDTO getDeviceDetail(String deviceId);
    
    /**
     * 获取所有在线设备
     *
     * @return 设备列表
     */
    List<DeviceDTO> getOnlineDevices();
    
    /**
     * 发现设备（广播）
     *
     * @return 发现的设备数量
     */
    int discoverDevices();
    
    /**
     * 根据IP地址获取设备
     *
     * @param ipAddress IP地址
     * @return 设备信息
     */
    DeviceDTO getDeviceByIp(String ipAddress);
    
    /**
     * 将实体转换为DTO
     *
     * @param device 设备实体
     * @return 设备DTO
     */
    DeviceDTO convertToDTO(Device device);
} 